home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / adtutl10.zip / ADT.DOC next >
Text File  |  1992-09-21  |  10KB  |  347 lines
  1.                     The ADT-utils
  2.  
  3.  
  4. LICENSE
  5. -------
  6.  
  7. These programs are copyrighted shareware-products for private and educational
  8. use. You may copy and use them, but you must leave the files unaltered.
  9.  
  10. If you regularly use (some of) these programs...
  11.  
  12.     -if you live in the European Community, send the equivalent of 5 ECU to
  13.      account nr.
  14.  
  15.         979-3812705-28
  16.  
  17.         (Andreas De Troy
  18.         Fehrenbachstraat 18
  19.         2440 Geel
  20.         Belgium)
  21.  
  22.     -else, send 6$ to a charity organisation of your choice (and don't
  23.      hesitate to write me a letter about it !)
  24.  
  25. Thanks in advance.
  26.  
  27.  
  28. All the programs are compiled with Borland C, version 3.0
  29.  
  30. These programs must not be sold for profit.
  31.  
  32.  
  33. COMMENTS AND PROBLEMS
  34. ---------------------
  35.  
  36. Comments, improvements, suggestions and problems may be sent to
  37. the author
  38.  
  39. Andreas De Troy
  40. Fehrenbachstraat 18
  41. 2440 Geel
  42. Belgium
  43.  
  44. E-mail: Andreas%PSL%PSY@cc3.kuleuven.ac.be
  45.  
  46. THANKS
  47. ------
  48.  
  49. Thanks to Johan Van Rensbergen
  50.  
  51.  
  52. SYSTEM REQUIREMENTS
  53. -------------------
  54.  
  55. IBM or compatible computer
  56. DOS 3.00 or above
  57.  
  58.  
  59. CONTENTS
  60. --------
  61.  
  62. ******************************** NOTE ************************************
  63. -all the programs accept the "/?"-option to display help-information
  64. -most of them accept a "/w"-option to store defaults into the EXE-file
  65. -options followed by '∙' can be turned on/off with +/-.
  66.  
  67.     example:
  68.  
  69.     XUPDATE a: /b+           (full backup ON)
  70.     XUPDATE a: /b-           (full backup OFF)
  71.  
  72. -for most programs it does not matter whether the <filespec> comes before
  73.  the <options> or vice versa
  74. -many programs are already available from other authors (public domain etc.).
  75. In these cases I give a short reason why you would want to use THESE programs
  76. instead of the ones that are already available.
  77. **************************************************************************
  78.  
  79.  
  80. ADT.DOC
  81.     This file.
  82.  
  83. CUT.EXE
  84.     a program to cut a (large) file (<filename>.<ext>) into smaller parts
  85.     (with names <filename>.001, <filename>.002 etc.): if a file is too large
  86.     to be copied to one floppy, CUT.EXE can be used to split the file and
  87.     copy the parts.
  88.     The DOS-command "copy" can be used to "paste" the pieces afterwards.
  89.  
  90.     EXAMPLE:
  91.         CUT /720 huge.txt
  92.         ("cut the file huge.txt into pieces of 720 Kb. The pieces are
  93.           stored as huge.001, huge.002, ..."). "/720" is optional; it
  94.           will be asked if not specified.
  95.  
  96.     Type "CUT /?" for help information.
  97.  
  98. DD.EXE
  99.     shows the files in a directory. The output can be sorted in many ways. The
  100.     input can be filtered using +,-,∙ ("or, minus, and <ASCII 249>"), /TODAY,
  101.     /PROGS, /SUB, etc. .
  102.  
  103.     WHY USE IT ?
  104.  
  105.         The output is shown in 1,2,3... columns, depending on the screen-
  106.         resolution (40,80,132,... columns). So you will get more information
  107.         on your screen. Files can be grouped (/PROG, /SUBDIR, etc.) and
  108.         combined.
  109.  
  110.     USAGE: DD <specs> <options>
  111.  
  112.         <specs>   : filenames (wildcards allowed), optionally separated by
  113.                   + - ∙ (for logical OR, NOT, AND)
  114.  
  115.         <options> :
  116.             /N   sort on name
  117.             /E   sort on extension
  118.             /S   sort on size
  119.             /D   sort on date
  120.             /T   sort on time
  121.             /-   do not sort
  122.             /w   write new sort-defaults into DD.EXE
  123.  
  124.             /ARchived: arc+zip+zoo+lzh+pak+pka...
  125.             /Programs: programs only
  126.             /TExt    : txt+doc+me
  127.             /SOurce  : c+cpp+h+pas+bas
  128.             /SUbdirs : subdirectories only
  129.             /TOday   : today only
  130.             /Before  : before <date>
  131.             /AFter   : after <date> (incl.)
  132.  
  133.  
  134.     EXAMPLE:
  135.         DD *.doc + *.obj /TODAY /t
  136.         ("show *.doc and *.obj created today, and sort them on time")
  137.  
  138.         DD *.exe /AFTER 1-1-92
  139.         ("show *.exe created after 1-1-92")
  140.  
  141.     Type "DD /?" for help information.
  142.  
  143. DELDIR.EXE
  144.     deletes a directory and its subdirectories, even if the current directory
  145.     is involved or if the directories are on another drive.
  146.  
  147.     WHY USE IT ?
  148.  
  149.         If the current directory is deleted, the new directory-name is shown
  150.         to avoid confusion.
  151.  
  152.     USAGE: DELDIR <options> <directoryname>
  153.  
  154.         /h∙  : delete hidden files    (/h+ = yes, /h- = no)
  155.         /r∙  : delte read-only files  (/r+ = yes, /r- = no)
  156.         /s∙  : delete system files    (/s+ = yes, /s- = no)
  157.         /p∙  : prompt each time before deleting subdir (/p+ = yes, /p- = no)
  158.         /x∙  : directories may have an extension (/x+ = yes, /x- = no)
  159.                 with /x-, directories with extension are not recognized and
  160.                 not deleted, but the search for subdirs will be much faster
  161.         /w   : write new defaults into DELDIR.EXE
  162.  
  163.     EXAMPLE:
  164.         DELDIR . /p-
  165.         ("delete the current directory + subdirs without prompt")
  166.  
  167.     Type "DELDIR /?" for help information
  168.  
  169. DOUBLESS.EXE
  170.     searches one or more disk(s) for duplicates, and asks for each duplicate
  171.     whether it has to be deleted or not (optionally).
  172.     Directories can be excluded before (incl. subdirs) and during program-
  173.     execution. In the latter case only the named directories are excluded,
  174.     not the subdirs of this directories.
  175.     The mouse can be used to answer Yes/No (Left/Right).
  176.  
  177.     USAGE: DOUBLESS <filespec> <options>
  178.  
  179.         <filespec>
  180.             wildcards allowed; even drives. Maximum 8, separated by space(s).
  181.  
  182.         /p∙ : prompt for deletion (/p+ = yes, /p- = no). Each file that is
  183.              present more than once, will be shown and you will be asked
  184.              whether it has to be deleted or not. /p- means: no deletion at
  185.              all, just show the filenames.
  186.         /e∙ : exclude subdirectories (/e+) or not (/e-). The names of the
  187.              subdirs that you want to exclude are asked. Use this if you
  188.              have used some subdirs for a backup.
  189.         /x∙ : see DELDIR.EXE
  190.         /w  : see DELDIR.EXE
  191.  
  192.     EXAMPLE:
  193.         DOUBLESS A:*.doc C:\bin
  194.         ("search for duplicate *.doc-files in A:, starting from the root,
  195.           and in C:, starting from the directory \bin")
  196.  
  197.     Type "DOUBLESS /?" for help information
  198.  
  199.  
  200. SEARCH.EXE
  201.     searches a particular file on disk.
  202.     Wildcards may be used.
  203.  
  204.     WHY USE IT ?
  205.         the search may be interrupted at any moment by pressing <ESC>.
  206.  
  207.     USAGE: SEARCH <filespec> <options>
  208.  
  209.         /d  : search on date
  210.              (files must match a particular date, between <date 1>
  211.              and <date 2>)
  212.         /s  : search on size
  213.              (files must match a particular size, between <size 1>
  214.              and <size 2>)
  215.         /x∙ : see DELDIR.EXE
  216.         /w  : see DELDIR.EXE
  217.  
  218.     EXAMPLE:
  219.         SEARCH *.bak
  220.  
  221.     Type "SEARCH /?" for help information
  222.  
  223. WC.EXE
  224.  
  225.     gives wildcard-facilities to any program. If you have a program that
  226.     does not accept wildcards, precede it with WC. For instance, for a program
  227.     (CV.EXE) that converts an .IN-file to some kind of outputfile, type...
  228.  
  229.         WC cv *.in *.out
  230.  
  231.         (-> all the .IN-files will be converted by CV.EXE to .OUT-files,
  232.          even if these .OUT-files did not exist yet)
  233.  
  234.     WC can also be used for programs that DO accept wildcards: WC will give
  235.     you the choice whether to execute the program or not on each particular
  236.     file.
  237.  
  238.     USAGE: WC <wc-options> <any program, incl. options, inputfiles etc.>
  239.  
  240.        <wc-options>:
  241.  
  242.         /p∙    : prompt/do not prompt before executing (/p- = no, /p+ = yes)
  243.         /d∙    : files must match a particular date, between <date 1> and
  244.                 <date 2>
  245.         /s∙    : files must match a particular size, between <size 1> and
  246.                 <size 2>
  247.         /1../9 : wildcards based on argument 1..9.
  248.  
  249.             Example:
  250.  
  251.                suppose you have a program, called PROG.EXE, that accepts 1
  252.                inputfile to create 2 outputfiles (that do not exist yet).
  253.                If the <usage> of this program is
  254.  
  255.                     Usage: PROG <input> <output 1> <output 2>
  256.  
  257.                ... then type:
  258.  
  259.                         wc /1 prog *.in *.ou1 *.ou2
  260.  
  261.                         (use all the .in-files on disk to produce .ou1 and
  262.                         .ou2-files)
  263.  
  264.               But with
  265.  
  266.                     Usage: PROG <output 1> <output 2> <input>
  267.  
  268.               type:
  269.  
  270.                         wc /3 prog *.ou1 *.ou2 *.in
  271.  
  272.                         (use all the .in-files on disk to produce .ou1
  273.                         and .ou2-files). "/3" means: use the third
  274.                         argument to derive the name of the outputfiles.
  275.  
  276.         /w     : see DELDIR.EXE
  277.  
  278.     EXAMPLE
  279.         WC del *.bak
  280.         ("delete all BAK-files one by one, with a prompt for each")
  281.  
  282.     Type "WC /?" for help information
  283.  
  284.  
  285. XUPDATE.EXE
  286.  
  287.     updates files that have the same name but differ in time of creation.
  288.     Each file is presented on screen before being updated.
  289.  
  290.     W